目录

• 概述
  • 酒店创建信息流
  • 产品创建信息流
  • ARI消息流
  • 订单消息流
• 安全与认证
• JSON 服务
• 消息头
• 终端地址
• IP 地址
• 成功与失败响应
  • 错误处理
  • 错误响应

概述

PC Integration API  允许 PMS 公司集成 DerbySoft Property Connector，用于 ARI、预订和住宿记录的数据交换，以及创建酒店、房价 和 房型。 PMS 厂商可以通过德比软件PC Integration API  连接德比软件渠道分销服务，增强 PMS 厂商渠道分销服务。 

在房价、房量、可用性 (ARI) 和订单的数据交互上德比软件采用是“推/推”模型。

1. PMS 将酒店信息推送至德比软件，在Property Connector里创建酒店。
2. PMS 将房价&房型数据推送至德比软件，在Property Connector里创建产品。
3. PMS 将 ARI 推送至德比软件，德比软件会将数据异步存储到数据库中。
4. PMS推送渠道设置信息至德比软件 ，在Property Connector中创建或更新指定渠道的设置。
5. PMS推送渠道mapping至德比软件，在Property Connector中更新渠道和酒店产品对应关系。
6. 德比软件将分销商的预订信息推送到 PMS，并将确认或错误信息直接反馈给分销商。
7. PMS 将入住信息推送至德比软件，德比软件会生成相应的数据报告。

酒店创建信息流

产品创建信息流

ARI消息流

渠道管理信息流

订单消息流

安全与认证

PC Integration API 使用Bearer Token处理访问身份验证。我们的系统在调用API服务时验证每条消息。请联系 pms.service@derbysoft.net获取Client ID和Client Secret，同时集成到我们的对接中并通过调用Token Obtain&Refresh接口获取bearer token。

以下为调用示例：

POST /pcapigateway/tunnel/{accountId}/rate HTTP/1.1
Authorization: Bearer 53ac07777cdffac2d53000002d698728ce964432d7167596bc005c5fc
Accept-Encoding: gzip
Content-Type: application/json;charset=utf-8

重要信息：
我们的系统通过 HTTPS 支持 TLSv1.2 及以上版本，请确保您的应用程序与之兼容。

JSON 服务

PC Integration API 基于 JSON restful API 下设计，该 API 遵循 RFC4627 规范。为了确保我们的应用程序可以正确解析您的请求，请在您的 HTTPS 请求中添加  Content-Type: application/json;charset=utf-8”

重要信息：
UTF-8 是我们唯一支持的字符编码和解码字符集，确保您的应用程序可以接受一些非拉丁字符，如客人姓名、注释等。

每个请求和响应中都有一个共同的消息头 (Message Header），用以跟踪 PMS 和德比软件之间的交互。德比软件将它们记录在日志系统中用于进行故障排除。建议您在 PMS 系统也可以记录它们，并将它们提供给我们，以便将来进行问题调查。

终端地址

IP 地址

如果您必须设置 IP 白名单，请使用以下IP地址：

成功与失败响应

PC Integration API 遵循 HTTP 状态代码标准，以指示成功响应或失败响应。HTTP 状态代码 200 表示请求在服务器中处理良好，HTTP 状态代码 500 表示发生了错误。

请遵循此标准，因为它有助于与某些第三方监控系统和跟踪系统集成。

错误处理

希望您的 PMS 具有强大的错误处理流程，包括排队机制和稳健的重试策略。

错误响应应包含错误简要描述，有利于我们的团队排查问题。

{
  "header": {
    "echoToken": "f67ade36-0b83-49cf-bfb1-b932c45b7d34",
    "timeStamp": "2018-06-27T17:09:04.674Z",
    "version": "1.00"
  },
  "errorCode": "InvalidField",
  "errorMessage": "Invalid token"
}

错误响应

发生业务错误时常见的错误响应。

注意事项：
错误响应始终与消息标题一起出现，并且仅显示在 HTTP 状态代码 500 中。